home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / C2SND201.ZIP / PPWAV.DOC < prev    next >
Text File  |  1994-09-11  |  5KB  |  120 lines
  1.        Ppwav, RIFF WAVE File Preprocessor
  2.        ----------------------------------
  3.  
  4.        Version 1.0
  5.  
  6.        Written by:
  7.          Jeffrey L. Hayes
  8.          130 Forest Ave., Lot 1
  9.          Orono, Me. 04473
  10.          (207) 866-7903
  11.          Internet:  tvdog@delphi.com
  12.  
  13.        This program is in the public domain.
  14.  
  15.        Ppwav (preprocess .wav) performs 3 types of conversions of a 
  16.        .wav file to reduce its size.  All of these conversions can be 
  17.        done with Sox (see Conv2snd.doc) but Ppwav is much faster and 
  18.        easier to use.  Ppwav needs about 53k of free RAM for its 
  19.        buffers.
  20.  
  21.        To use Ppwav, type its name followed by the input file name and 
  22.        the output file name, e.g.:
  23.  
  24.            PPWAV PING1.WAV PG.WAV
  25.  
  26.        On my system, this will start up Ppwav on PING1.WAV, a 16-bit 
  27.        stereo 44kHz .wav and create a new sound file, PG.WAV.  (In 
  28.        case you're wondering, PING1.WAV is a sonar ping taken from the 
  29.        movie "Hunt for Red October.")  File extensions must be 
  30.        specified.
  31.  
  32.        Ppwav will then display some statistics on the input file, for 
  33.        example:
  34.  
  35.            Input file:  PING1.WAV
  36.                    2 channels
  37.                    44100 samples per second (Hz)
  38.                    16 bits per channel
  39.                    samples are signed
  40.  
  41.        It will then ask you what conversions you want to do:
  42.  
  43.                    Mix to mono? (Y/n)
  44.               Convert to 8-bit? (Y/n)
  45.            Halve sampling rate? (y/N)
  46.  
  47.        The first two conversions are the default, as indicated by the 
  48.        uppercase "Y".  They will be done unless you enter "n" or "N" 
  49.        at the prompt.  The last conversion will not be done unless you 
  50.        enter "y" or "Y".  The conversion may take up to a minute or so 
  51.        if you work from the hard drive, depending on the length of the 
  52.        file.  If you don't want to convert, just find out what kind of 
  53.        .wav it is, hit <cntrl>-C at the prompt (an empty output file 
  54.        will be created, so use NUL as the output file to do this).
  55.  
  56.        All of these conversions will reduce the size of the file.  
  57.        With the Tandy DAC, mixing to mono and converting to 8-bit do 
  58.        not affect the sound quality since those conversions have to be 
  59.        done by the player anyway; 8-bit mono sound is all the Tandy 
  60.        chip supports.  Halving the sampling rate will adversely affect 
  61.        the sound quality, however, and you should only do this as a 
  62.        last resort.  I find that 22kHz is about the minimum for 
  63.        acceptable music, and 11kHz for speech.  Halving the sampling 
  64.        rate is done by discarding every other sample.
  65.  
  66.        If you haven't noticed, standard sampling rates are 5.5kHz, 
  67.        11kHz, 22kHz and 44kHz.  44kHz 16-bit stereo is what audio CD's 
  68.        are recorded at.  Sound.pdm supports 5.5kHz, 11kHz, and 22kHz.
  69.  
  70.        Ppwav can also handle some rare .wav types:  sampling rates 
  71.        greater than 65535Hz, more than 2 channels, and more than 16 
  72.        bits per channel.  At least I think it will, it's supposed to.  
  73.        I've never seen a .wav like that.  It will not handle all 
  74.        possible .wav's, however (just all that you are likely to see).
  75.  
  76.        Ppwav doesn't display anything else unless something goes 
  77.        wrong.  Here are the error messages:
  78.  
  79.            Usage: PPWAV <input file> <output file>
  80.            - see docs for details.
  81.  
  82.        You get this message if you don't specify an input file and an 
  83.        output file on the command line.  There is no default for the 
  84.        output file; you have to specify it.
  85.  
  86.            Error opening input file.
  87.  
  88.        You get this message if the file you specified as the input 
  89.        file does not exist.  There is a remote possibility of some 
  90.        other cause, but probably you mistyped.
  91.  
  92.            Unable to create output file.
  93.  
  94.        DOS reported that the output file could not be created.  Check 
  95.        to make sure that you specified a valid filename.  Also check 
  96.        to make sure that the diskette you're putting the output file 
  97.        on is not write-protected, if you're using floppies.
  98.  
  99.            Error reading input .wav file.
  100.  
  101.        DOS reported an error reading the input file.  This probably 
  102.        means that the disk structure is corrupt, and you should run 
  103.        Chkdsk to find out.  Ppwav does not replace the default 
  104.        critical error handler, so if you have a bad spot on the disk, 
  105.        you will get the infamous "Abort, Retry, Ignore, Fail?" message 
  106.        instead of this one.  "Ignore" to continue; the output file may 
  107.        have a short "click" in it, at most.
  108.  
  109.            Error writing output .wav file.
  110.  
  111.        The disk structure is probably corrupt.  Ppwav ignores a full 
  112.        disk; you just get as much of the output file as will fit.  
  113.        Note that not all .wav players will be able to play the frag- 
  114.        ment.
  115.  
  116.            Input .wav file invalid or unsupported type.
  117.  
  118.        The input file specified is not a .wav or is corrupt, or it is 
  119.        one of the rare .wav types that Ppwav does not recognize.
  120.